@Florence-Njeri

We are missing some content here.

So the thing is that there are 2 ways (actually 3 😄 ) to install AsyncAPI generator

• generator is a library that anyone can also use in their Nodejs applications. Like we do in our server-api -> https://github.com/asyncapi/server-api/blob/master/package.json#L49
  So you use it as library, not its CLI. You install it like npm install @asyncapi/generator, not with -g flag, as you do not install it globally but only inside your project. Sample code -> https://github.com/asyncapi/server-api/blob/master/src/services/generator.service.ts#L18-L29. **We need this covered in this document too, I mean info that it is a library and how to install in a project (same npm and nodejs restrictions)
• generator also contains cli. Atm PR to introduce generator in @asyncapi/cli is still not merged. So I suggest, for now, forget about it. Do not mention how to install @asyncapi/cli (also remove MacOS instructions as they are valid only for AsyncAPI CLI, not generator CLI). So focus only on @asyncapi/generator please

(actually 3 😄 )

it would be nifty to mention that if someone wants to use Generator CLI in CI/CD to automate generation (many people do it), then whey should just install generator CLI in their CI/CD, but in case of GitHub Actions, they can use https://github.com/marketplace/actions/generator-for-asyncapi-documents

I hope I'm not confusing, please lemme know if you need more help

few minors

also please add these new docs here https://github.com/asyncapi/generator/blob/master/docs/README.md

After Intro, and 2nd and 3rd doc

LGTM 🚀
@alequetzalli wanna have a final look before I merge?

lgtm 🚀

@alequetzalli wanna approve before merge?

MERGING TIME BABY 🚢 🚢 🚢 🚢 🚢 🚢